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Chapter  1 


Preface 


In  this  chapter: 


Typographical  Conventions 5 

Feedback 6 


Typographical  Conventions 

Before  you  start  using  this  guide,  it  is  important  to  understand  the  documentation 
conventions  used  in  it. 

The  following  kinds  of  formatting  in  the  text  identify  special  information. 

Formatting  convention  Type  of  Information  Example 


Special  Bold 

Items  you  must  select, 
such  as  menu  options, 
command  buttons,  or 
items  in  a list. 

Go  to  the  System  tab. 

Titles  of  chapters, 
sections,  and  subsections. 

Read  the  Basic 
Administration  chapter. 

Italics 

Used  to  emphasize  the 
importance  of  a point,  to 
introduce  a term  or  to 
designate  a command  line 
placeholder,  which  is  to  be 
replaced  with  a real  name 
or  value. 

The  system  supports  the 
so  called  wildcard 
character  search. 

Monospace 

The  names  of  commands, 
files,  directories,  and 
domain  names. 

The  license  file  is  located 
in  the 

http : //docs /common/ 
licenses  directory. 
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Pre format ted 


Preformatted 

Bold 


On-screen  computer 
output  in  your  command- 
line sessions;  source  code 
in  XML,  C++,  or  other 
programming  languages. 

What  you  type,  contrasted 
with  on-screen  computer 
output. 


# Is  -al  /files 

total  14470 


# cd  /root/rpms/php 


CAPITALS 


Names  of  keys  on  the  SHIFT,  CTRL,  ALT 
keyboard. 


KEY+KEY  Key  combinations  for  CTRL+P,  ALT+F4 

which  the  user  must  press 
and  hold  down  one  key 
and  then  press  another. 


Feedback 


If  you  have  found  a mistake  in  this  guide,  or  if  you  have  suggestions  or  ideas  on  how  to 
improve  this  guide,  please  send  your  feedback  using  the  online  form  at 
http://www.parallels.com/en/support/usersdoc/.  Please  include  in  your  report  the 
guide’s  title,  chapter  and  section  titles,  and  the  fragment  of  text  in  which  you  have 
found  an  error. 


Chapter  2 


Preparing  for  Parallels  H-Sphere 
Installation 


This  chapter  provides  comprehensive  information  on  how  to  prepare  Linux  and  Unix 
servers  for  the  installation  of  Parallels  H-Sphere  components. 


Note:  configuration  files  for  Apache,  FTP,  PHP,  DNS,  MySQL,  and  PostgreSQL  should 
be  customized  indirectly  via  respective  template  files.  Otherwise,  all  custom  changes  in 
major  default  configuration  files  are  removed  with  each  H-Sphere  update!  If  you  need 
those  files  customized,  please  carefully  follow  the  configuration  file  templates 
customization  instruction  in  Appendix  C (on  page  38). 


In  this  chapter: 


Supported  Operating  Systems 7 

Single-Server  and  Multi-Server  Installation 9 

Required  Components  and  Configuration 12 


Supported  Operating  Systems 

Before  requesting  a Parallels  H-Sphere  installation,  install  one  of  the  following 
operating  systems. 


Operating  System 

Supported  OS  Version 

RedHat  Enterprise  Linux 

5.x  (i386,  X86-64) 

6.x  (i386,  X86-64) 

CentOS 

5.x  (i386,  X86-64) 

6.x  (i386,  X86-64) 

CloudLinux 


5.6  (i386,  X86-64) 
6.3  (i386,  X86-64) 


Important: 

1 . FreeBSD:  Control  Panel  installed  on  a server  with  64-bit  operating  system  requires 
glibc  32-bit  compatibility  library. 

2.  CloudLinux  is  supported  as  a RedPlat  Enterprise  Linux  clone.  The  customizations 
allowed  by  it  are  not  propagated  to  Ul,  and  should  be  performed  manually  according  to 


instructions  published  on  the  CloudLinux  site,  if  needed. 
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Single-Server  and  Multi-Server  Installation 

General  Considerations 

Parallels  H-Sphere  can  be  installed  on  one  or  more  servers.  The  required  number  of 
servers  and  their  hardware  configuration  will  largely  depend  on  the  number  of  accounts 
you  are  planning  to  host,  Web  and  mail  quotas,  traffic  load  and  other  related  factors. 

Here  are  some  general  considerations  common  to  Parallels  H-Sphere  server 
environment: 

■ We  recommend  installing  Control  Panel  to  a separate  server.  It  is  also  acceptable 
to  install  one  DNS  server  to  the  Control  Panel  server  box,  for  example,  if  you  are 
planning  2-server  installation. 

■ You  must  not  install  PostgreSQL  hosting  service  on  the  same  box  with  Control 
Panel,  as  the  latter  requires  a separate  PostgreSQL  server  for  its  system  database. 

■ You  can  have  several  DNS  servers  on  one  box.  However,  for  multiserver  Parallels 
H-Sphere  installation,  you  should  install  each  DNS  server  on  a separate  box.  The 
best  solution  is  to  have  two  DNS  servers  on  separate  boxes. 

■ We  advise  installing  mail  server  on  the  same  box  with  MySQL  server,  as  mail 
server  requires  its  own  MySQL  database. 

■ It  is  reasonable  to  allocate  separate  physical  servers  for  the  most  resource- 
consuming services.  Usually,  these  are  Web  and  mail  servers,  but  sometimes  it 
may  be  MySQL  and  PostgreSQL. 

According  to  these  recommendations,  the  following  4-server  installation  may  be  an 
optimal  solution: 

■ Server  1 : Control  Panel  (with  the  system  PostgreSQL  database); 

■ Server  2:  Webl  + DNS1 ; 

■ Server  3:  Mail  + MySQLI  (user  DB)  + DNS2; 

■ Server  4:  PostgreSQL  (user  DB)  + MySQL2  (user  DB). 

Later  on,  you  may  add  more  boxes  to  your  system,  as  your  needs  grow: 

■ Server  5:  Web2; 

■ Server  6:  Mail2  (with  its  own  MySQL  DB); 


Hardware  Requirements 

If  you  are  going  to  install  Parallels  H-Sphere  to  only  one  computer,  make  sure  it  is  at 
least  Pentium  III,  500MHz  CPU  and  512MB  RAM.  This  will  allow  to  host  only  a small 
number  of  customers.  Adding  Parallels  SiteStudio  will  require  at  feasMOOOMHz  CPU 
and  1GB  RAM. 


Sample  1/2/3-Server  Configurations 


Below  are  sample  1 /2/3-server  H-Sphere  installations  with  preferable  partitioning 
schemes  outlined. 


One  Server  Installation 


Two  Server  Installation 


Three  Server  Installation 


Single-server  installation 
includes  Control  Panel,  DNS, 
Web,  mail,  and  MySQL 
services.  The  PostgreSQL 
hosting  service  isn’t  included 
because  of  the  Parallels  hl- 
Sphere  system  PostgreSQL 
database. 

Make  sure  you  have  at  least 
two  IPs  available,  because 
some  features  (like 
OpenSRS)  require  at  least 
two  DNS  servers. 

Examples: 

40GB  HDD: 

/root  partition  (/etc,  /tmp, 

/root)  - 1-3  GB 

/usr  - 3-5  GB 

/var  - 5-7  GB  for  mail  and 

MySQL  files 

/hsphere  (or /home)  - the 
remaining  disk  space  for 
Parallels  H-Sphere 
installation  and  Web  hosting. 

80GB  HDD: 


Consider  the  following 
partitioning  scheme  for  the 
two-server  configuration: 


Consider  the  following 
partitioning  scheme  for  a three- 
server  configuration: 


1)  Control  Panel  + DNS2:  1)  Control  Panel 


The  partitioning  requirements 
are  similar  to  those  for  one 
server  installation.  This  box 
will  have  the  Parallels  Pi- 
Sphere  control  panel,  the 
system  database,  DNS 
server,  and  Parallels 
SiteStudio  (optional). 

2)  Web  + Mail  + MySQL  + 
PostgreSQL  + DNS1 : 

/-  1-3GB 
/usr  -3-5  GB 

/var  - 5-7  GB  for  mail  and 
MySQL  files. 

/hsphere  - takes  the  rest  of 
the  space  for  Web  content 
and  is  the  biggest  partition. 


The  partitioning  requirements  are 
the  similar  to  those  for  the  one 
server  installation.  This  box  will 
have  the  Parallels  H-Sphere 
control  panel,  the  system 
database,  and  Parallels 
SiteStudio  (optional). 

2)  Web  + DNS2: 

/-  1-3GB 
/usr  - 3-5  GB 
/var  -3-5  GB 

/hsphere  - takes  the  rest  of  the 
space  and  is  the  biggest  partition. 

3)  Mail  + DNS1  + MySQL  + 
PostgreSQL: 

/-  1-3GB 
/usr  - 3-5  GB 

/var  - takes  the  rest  of  the  space 
for  mail  and  MySQL  files. 


/ root  partition  (/etc,  /tmp, 

/root)  - 2-6  GB 

/usr  - 6-10  GB 

/var  - 1 0-1 5 GB  for  mail  and 

MySQL  files 

/hsphere  (or /home)  - the 
remaining  disk  space  for 
Parallels  H-Sphere 
installation  and  Web  hosting. 

120+  GB  HDD: 


/ root  partition  (/etc,  /tmp, 

/root)- 3-10  GB 

/usr  - 10-20  GB 

/var  - 15-30  GB  for  mail  and 

MySQL  files 

/hsphere  (or /home)  - the 
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remaining  disk  space  for 
Parallels  H-Sphere 
installation  and  Web  hosting. 

The  more  users  you  are 
planning  to  have,  the  more 
disk  space  is  required.  If  you 
want  to  have  Parallels 
SiteStudio,  it  will  also  be 
installed  onto  this  partition. 
However,  this  will  require  at 
least  512  RAM  and  a 500MHz 
processor. 

In  addition,  you  can  create  a 
separate  mail  partition  for  the 
Parallels  H-Sphere  mail 
system.  Its  size  will  depend 
on  your  mail  quotas  for  users 
and  the  number  of  mailboxes. 


HDD  Partitioning 

Parallels  H-Sphere  is  installed  to  the  /hsphere  directory. 

We  recommend  dedicating  a separate  partition  for  the  Parallels  H-Sphere  installation 
directory  and  mount  it  as  /hsphere. 

# mkdir  -p  /hsphere 

# chmod  755  /hsphere 

Parallels  H-Sphere  directory  can  be  located  on  any  other  partition  as  well.  However,  we 
do  not  recommend  installing  Parallels  H-Sphere  to  the  root  / partition.  Having  Parallels 
H-Sphere  on  the  root  partition  may  cause  certain  problems.  For  instance,  if  disk  quota 
gets  damaged,  you  cannot  repair  it  without  server  reboot  and  f sck  check  in  the  single 
user  mode. 

If  your  Parallels  H-Sphere  installation  directory  is  to  be  located  on  another  partition,  for 
example,  /usr/hsphere  on  the  /usr  partition,  the /hsphere  symlink  to  this 
directory  must  be  anyway  created: 

# mkdir  -p  /usr/hsphere 

# In  -s  /usr/hsphere  /hsphere 

# chmod  755  /usr/hsphere 


Important:  Do  not  create  /hsphere  as  a symlink  to  another  partition  on  servers  with 
FreeBSD  5.3  and  up!  Allocate  the  separate  /hsphere  partition  instead!  If  this  is 
impossible,  use  nuiifs  partitioning  for  this  purpose. 


There  are  no  more  requirements  to  partitioning  the  servers,  just  make  sure  there  is 
enough  disk  space  to  store  user  and  other  Parallels  H-Sphere  data. 


Required  Components  and  Configuration 

Prior  to  the  installation,  make  sure  your  server  is  configured  properly  and  has  all  necessary 
components. 

In  this  section: 


Open  SSH 12 

Kernel 13 

Locale 14 

Disk  Quota 14 

Quotacheck 15 

Ports 15 

DNS  Server  Notes 20 

Perl 20 

Make 20 

Command-Line  URL  Download  Utility  (wget  or  fetch) 21 

Compat3x  Package 21 

SELinux  Must  Be  Off 21 

Libmap  Content 21 

ifconfig 22 


Open  SSH 

1.  Install  OpenSSH  package  on  each  Parallels  H-Sphere  box.  You  can  use 
standard  RPMs  under  Linux  or  packages  under  FreeBSD.  Usually,  the 
standard  Linux  and  FreeBSD  installations  contain  the  OpenSSH  package, 
you  can  use  it  without  any  restrictions.  However,  we  recommend  updating 
the  package  to  the  latest  version.  SSH  keys  need  to  be  configured  under  the 
cpanel  user. 

2.  To  enable  Permit  Root  Login,  open  file  /etc/ssh/sshd_conf  ig  and 
uncomment  the  line: 

PermitRootLogin  yes 

Make  sure  PermitRootLogin  is  set  to  yes.  Then  restart  SSH: 

■ for  Linux: 

/etc/init .d/sshd  restart 

■ for  FreeBSD: 

/etc/rc. d/sshd  restart 

3.  Enable  the  OpenSSH  daemon  start  at  server  startup. 

4.  Start  the  OpenSSH  daemon 


Kernel 

We  strongly  recommend  using  typical  Linux/FreeBSD  kernel  (i.e.,  coming  with  official  OS 
distributives  or  updates).  In  particular,  in  case  of  FreeBSD  we  insist  on  GENERIC  kernel  with 
basic  configuration.  We  do  not  guarantee  correct  Parallels  H-Sphere  work  on  a server  with 
customized  kernel!  Please  carefully  test  Parallels  Pi-Sphere  functionality  on  such  a server 
before  it  becomes  a production  server! 


Locale 


Please  make  sure  that  the  Control  Panel  server’s  default  locale  is  set  to  en_us . utf-8. 

Disk  Quota 

Enable  the  disk  quota  feature  on  each  Parallels  H-Sphere  Web  server.  There  is  no  need  to 
enable  it  on  other  servers. 

> To  enable  disk  quota: 

1.  Log  in  as  root. 

2.  Insert  the  usrquota  directive  (userquota  for  FreeBSD)  into  the  /etc/fstab  file 
for  the  corresponding  partition. 

On  Linux,  it  must  look  similar  to  this: 

LABEL=/hsphere  /hsphere  ext2  defaults , usrquota  1 1 
On  FreeBSD,  it  must  look  similar  to  this: 

LABEL=/hsphere  /hsphere  ufs  rw, userquota  2 2 

3.  Execute  the  following  commands: 

quotaoff  /partition  with  userquota  enabled 

mount  -o  remount  /partition  with  userquota  enabled  (Linux  only, 
skip  this  line  with  FreeBSD) 

rm  -rf  /partition  with  userquota  enabled/aquota . user 
/ part ition_with_userquota_enabled/ quota .user 
quotacheck  -mufv  /partition  with  userquota  enabled (Linux) 
quotacheck  -guv  /partition  with  userquota  enabled (FreeBSD) 
quotaon  /partition  with  userquota  enabled 

4.  Perform  the  following  steps: 

a.  # touch 

/ part it ion_wi th_userquota_enabled/ a quota. user 

b.  # quotacheck  -m  /parti tion_with_userquota_enabled 

and  ignore  the  message: 

"quotacheck:  WARNING  - Quotafile 

/partition_with_userquota_enabled/aquota . user  was  probably 
truncated.  Can't  save  quota  settings..." 

# quotaon  /partition  with  userquota  enabled 

5.  FreeBSD  Web  server  installations:  Enable  disk  quota  in  the  kernel 
configuration.  Also,  in  /etc/def ault/rc . conf  set: 
enable_quotas="YES" 

Root  Partitions 

We  don’t  recommend  enabling  the  disk  quota  feature  on  root  partitions.  Use  other  partitions 
for  this!  Therefore,  we  advise  not  to  place  Parallels  H-Sphere  files  on  the  root  partition. 


Quotacheck 

Quota  versions  can  have  some  differences  on  different  operating  systems.  You  may  need  to 
execute  the  quotacheck  command  with  some  additional  parameters.  Please  read  the 
command  manual  before  performing  this  action. 

Ports 

In  your  firewall  settings,  open  the  following  ports  in  both  directions  and  specify  the 
connection  type  - top  or  udp  or  both. 

We  need  that  firewall  be  configured  by  our  customers. 


Note:  Pix  firewall  doesn’t  work  correctly  with  Parallels  H-Sphere  and  Parallels  SiteStudio, 
because  it  doesn’t  allow  servers  within  one  Parallels  H-Sphere  cluster  to  communicate  by 
external  IPs,  which  is  critical  for  both  products. 


Control  Panel  Server 


Port 

Usage 

Connection  Type 

Note 

20 

FTP-DATA 

top 

21 

FTP 

top 

22 

SSH 

top 

53 

DNS 

udp 

443 

HTTPS 

top 

873 

RSYNC 

top 

between 

Parallels  H- 
Sphere  servers 

1922 

IMAGEMAK 

ER 

top 

localhost  only 

3306 

MySQL 

top 

to  all  MySQL 
servers 

5432 

Postgres 

top 

CP  only 

8009 

Tomcat 

top 

CP  only 

8080 

HTTP 

top 

8443 

SSL 

top 

55000 


OpenSRS 


top 


if  used 


10125 


SOAP 


tcp 


between 
Parallels  H- 
Sphere  servers 


Mail  Server 


993 


Mail  SSL 


tcp 


open  this  port  only 
it  you  want  to  use 
Mail  SSL 


995 

Mail  SSL 

tcp 

open  this  port  only 

if  you  want  to  use 

Mail  SSL 

DNS  Server 


Port 

Usage 

Connection  Type 

Note 

22 

SSH 

top 

53 

DNS 

tcp  and  udp 

For  highest  security, 

open: 

■ udp  permanently 

■ tcp  worldwide 
during  Parallels 
H-Sphere 
installation  and 
post-installation 
tests 

■ tcp  between 
Parallels  H- 
Sphere  DNS 
servers 
permanently. 

873 

RSYNC 

tcp 

between  Parallels 
H-Sphere  servers 

953 

RNDC 

tcp  and  udp 

For  highest  security, 

open: 

■ udp  permanently 

■ tcp  worldwide 
during  Parallels 
H-Sphere 
installation  and 
post-installation 
tests 

■ tcp  between 
Parallels  H- 
Sphere  DNS 
servers 
permanently. 

MySQL  Server 


Port 


Usage 


Connection  Type 


Note 


22 


SSH 


tcp 


53  DNS  udp 

80  HTTP  tcp 

873  RSYNC  tcp  between  Parallels 

H-Sphere  servers 

PgSQL 


RealServer 


Windows  Server 


MS  SQL  Server 


MPS  Server 

Ports  Usage  Connection  Type  Note 

80  HTTP  tcp 

MRTG  Server 

Ports  Usage  Connection  Tye  Note 

80  HTTP 


443 

HTTPS 

Note:  all  ports  should  be  opened  for  external  connections  unless  specified  otherwise  (for 
example,  “tcp  between  Parallels  H-Sphere  servers"). 


DNS  Server  Notes 

1.  Port  953  (rndc)  should  be  open  for  localhost  only  if  your  DNS  server  is  using 
BIND  9.x. 

2.  If  your  DNS  server  is  using  BIND  8.x,  it  can  be  upgraded  to  run  with  Parallels 
H-Sphere,  but  old  domains  would  still  have  to  be  managed  by  hand.  Please 
agree  your  DNS  server  upgrade  with  our  installation  team. 

Please  mind  that  we  don’t  provide  support  for  Reverse  DNS  configuration. 

Perl 

Parallels  H-Sphere  installation  script  is  written  in  Perl,  therefore  Perl  is  required  on  each  box. 
To  check  if  Perl  is  installed,  run: 

perl  -V 

Caution:  Do  not  update  or  change  any  configuration  to  your  system  Perl,  as  it  will  most  likely 
damage  your  Parallels  H-Sphere  installation. 


Make 

Make  sure  the  make  utility  is  installed  on  every  box.  To  check  if  make  is  installed,  run: 


make  -v 


Command-Line  URL  Download  Utility  (wget  or  fetch) 

Parallels  H-Sphere  installation  script  requires  the  command-line  URL  download  utility,  wget 
for  Linux,  fetch  for  FreeBSD. 

Compat3x  Package 

On  FreeBSD  4.X  servers,  make  sure  to  have  the  compat3x  package  installed  for 
compatibility  with  3.x.  To  diagnose  if  your  compat3x  is  missing,  run: 

/ stand/ sysinstall 

and  then  go  to  Configure  ->  Distributions 

SELinux  Must  Be  Off 

(Red Hat  Enterprise  Linux  4,  CentOS  4 and  up,  and  White  Box  Enterprise  Linux  4 only) 
Before  Parallels  Pi-Sphere  installation,  make  sure  SELinux  is  off  on  your  Linux  servers. 

To  check  SELinux  status,  run: 

selinuxenabled  &&  echo  $? 

If  as  a result  of  this  command  you  receive  0,  SELinux  is  enabled.  No  result  means  that 
SELinux  is  off. 

To  disable  SELinux,  set  the  following  option  in  /etc/seiinux/conf  ig: 

SELINUX=disabled 

This  will  turn  off  SELinux  after  reboot.  To  disable  SELinux  immediately,  type: 
setenforce  0 

Libmap  Content 

If  you  are  to  install  Control  Panel  on  a FreeBSD  box,  especially  in  case  of  multiprocessor 
architecture,  please  make  sure  you  have  the  /etc/libmap . conf  file  on  the  Control  Panel 
box  with  the  following  content: 

[java] 

libpthread.so  libc_r.so 
libpthread.so.2  libc_r.so.6 

[javac] 

libpthread.so  libc_r.so 
libpthread.so.2  libc_r.so.6 


[/hsphere/shared/java/diablo-jdk1.5.0/bin/java] 


libpthread.so  libc_r.so 
libpthread.so.2  libc_r.so.6 

[/hsphere/shared/java/diablo-jdk1.5.0/bin/javac] 
libpthread.so  libc_r.so 
libpthread.so.2  libc_r.so.6 


If  you  want  to  install  Control  Panel  or  PostgreSQL  hosting  service  on  FreeBSD  7.4  or  8.3 
version  or  later,  please  make  sure  you  have  the  /etc/libmap.conf  file  on  this  server  with  the 
following  content: 

libintl.so.8  libintl.so.9 

ifconfig 

Make  sure  the  ifconfig  utility  on  the  Control  Panel  box  has  755’  permissions  by  running 

#which  ifconfig 

/path/ to/ ifconfig 

#chmod  755  /path/to/ifconf ig 


Chapter  3 


Installing  Parallels  H-Sphere 


To  install  Parallels  H-Sphere  from  scratch,  please  carefully  follow  the  instructions 
provided  below  in  this  chapter.  If  you  want  to  install  Parallels  H-Sphere  by  importing  a 
specially  formatted  conf  ig . xml  file,  refer  to  Appendix  A.  Installing  with  prepared 
Parallels  H-Sphere  configuration  (on  page  34). 

In  this  chapter: 


Step  1.  Running  the  Parallels  H-Sphere  Installation  Script 24 

Step  2.  Installing  the  Parallels  H-Sphere  via  Control  Panel 24 

Step  3.  Completing  Parallels  H-Sphere  Installation  Wizard 30 

Installing  Parallels  SiteStudio  with  Parallels  H-Sphere 31 
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Step  1.  Running  the  Parallels  H-Sphere 
Installation  Script 

1.  Log  into  the  server  where  you  install  Parallels  H-Sphere  as  root: 

$ su  -l 

2.  Download  the  Parallels  H-Sphere  install  script: 

Linux: 

# wget 

http : //download .hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

FreeBSD: 

# fetch 

http : //download .hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

3.  Run  the  install  script  with  the  install  option: 

# sh  ./U36.0P2  install 

4.  Choose  the  cpinstall  mode  to  install  basic  Parallels  H-Sphere 
packages  on  the  Control  Panel  server  to  be  able  to  run  Parallels  H- 
Sphere  Control  Panel.  In  the  installer’s  command  line  type  in  the 
following  command: 

cpinstall  zone=SERVICE_ZONE  ip=SERVICE_IP 

where  service_zone  is  the  service  domain  name  (for  example, 
samplehosting.com),  and  service_ip  is  the  service  domain  IP. 

This  will  start  the  Control  Panel  installation  process. 

You  can  find  more  info  on  Parallels  H-Sphere  installation  script  options  in  Appendix  B 
(on  page  36). 


Step  2.  Installing  the  Parallels  H-Sphere 
via  Control  Panel 

1.  Upon  successful  installation,  run  Parallels  H-Sphere  Control  Panel  at 
http:  //SERVICEJP:  80  80/  in  your  favorite  browser. 

Note:  If  you  have  problems  with  running  Control  Panel,  please  try  to  When  restarting 
the  Control  Panel,  make  sure  that  you  are  logged  into  the  Control  Panel  server  as  root. 


For  Linux: 
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/etc/rc.d/init.d/httpdcp  stop 
killall  -9  java 
sleep  10 

/etc/rc.d/init.d/httpdcp  start 
For  FreeBSD: 


/usr/local/etc/rc.d/apachecp.sh  stop 
killall  -9  java 
sleep  10 

/usr/local/etc/rc.d/apachecp.sh  start. 

1.  Log  into  Parallels  H-Sphere  Control  Panel  as  admin  with  password  admin. 
Later  on  you  will  be  able  to  change  the  administrator  password. 

After  you  log  in,  you  must  enter  your  valid  Parallels  H-Sphere  license  purchased 
from  the  Buy  Parallels  Support  and  Services  for  Parallels  H-Sphere  page. 
Otherwise,  you  won’t  be  able  to  proceed  with  the  installation.  H-Sphere  3.2  and  up 
introduces  licensing  through  a unified  Parallels  licensing  system. 

2.  Run  Parallels  H-Sphere  Installation  Wizard  which  allows  shaping  your 
Parallels  H-Sphere  cluster  by  adding  boxes  and  hosting  services  and 
configuring  basic  Parallels  H-Sphere  settings. 

Running  Parallels  H-Sphere  Installation  Wizard 

Now  that  you  ran  the  Parallels  H-Sphere  updater  in  the  installation  mode  with  the 
cpinstaii  option,  you  need  to: 


Step  1.  Manage  configuration  file 

Welcome  to  the  H-Sphere  pre-configuration  page.  Please  shape  your  H-Sphere  cluster 
before  you  complete  H-Sphere  installation  (update). 


Configuration  File 

Import  J|f  Export  Restore  to  Default 


General  Settings 

& 

System  Domain 

Type  of  Installation 

Multi  Server 

Use  NAT  IP  mapping 

No 

Physical  Servers 

ID  Name  Host  IP  Type 


Controls 


26 


Installation  Wizard  writes  the  Parallels  H-Sphere  cluster  configuration  into  the  specially 
formatted  config.xml  file  (see  sample  config.xml).  The  Configuration  File  section  on  the 
main  page  enables  you  to: 

■ Import:  You  upload  the  prepared  XML  file  from  a local  machine  to  Parallels  hl- 
Sphere  and  later  reconfigure  Parallels  H-Sphere  in  the  wizard.  Read  more  on 
Parallels  H-Sphere  installation  from  prepared  config.xml  file; 

■ Export:  export  config.xml  with  your  Parallels  H-Sphere  cluster  configuration  to  your 
local  machine. 

■ Restore  to  Default:  choose  this  option  to  recreate  config.xml  and  to  restart  configuring 
Parallels  H-Sphere  cluster  in  the  wizard. 

Step  2.  Edit  general  settings 

1 . Click  the  Edit  General  Settings  icon  on  the  right  corner  of  the  General  Settings 
caption  and  proceed  to  the  following  page: 


General  Settings 

System  Domain 

[example.psoft  + 

One-server  Installation 

F 

Use  NAT  IP  mapping 

F 

Submit 
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■ System  Domain:  Specify  the  service  domain  name  here. 

■ One  Server  Installation:  check  this  box  if  you  need  a single  server  installation.  You 
can’t  add  more  than  one  physical  server  by  checking  this  options. 

■ Use  NAT  IP  mapping:  Check  this  box  if  you  implement  NAT  (on  page  57)  on  your 
Parallels  H-Sphere. 

2.  Press  Submit  and  return  to  the  main  page  of  the  wizard. 

Step  3.  Add  physical  servers 

1 . Click  the  Add  Physical  Server  icon  on  the  right  corner  of  the  Physical  Servers 
caption. 

2.  Fill  in  the  form  for  adding  new  physical  servers  and  services: 

Physical  Server 


Name 

|test2 

+ . | example. psoft  ^ 

IP 

|l92. 168.116. 152 

+ 

Mask 

[255.255.255.0 

+ 

Password 


Use  defaults  for  this  server 
F Unix  Web  Server 
F Control  Panel 
F PostgreSQL  Server 
F DNS  Server 
F Mail  Server 
|2J  MySQL  Server 


Submit  | 
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3.  Set  physical  server  Name,  IP,  root  password,  and  choose  which  logical 
servers  (Control  Panel,  Web,  mail,  DNS,  MySQL,  PostgreSQL)  will  be 
installed  there.  They  will  be  installed  with  default  settings  which  can  be 
changed  if  necessary. 

4.  Click  Submit. 


After  you  have  added  physical  servers  into  Parallels  H-Sphere  cluster,  you  will  see 
them  on  the  main  page  of  the  wizard: 


Physical  Servers 

tj 

ID  Name 

Host  IP 

Type 

Physical  Server  Profile 

Controls 

20  cp.test45.psoft 

192.168.116.45 

[cp] 

UNIX  DEFAULT 

9 

[1] 

[Manage  install/update  profiles! 

Here  you  may  also  configure  physical  server  profiles,  setting  update  rules  for  each 
physical  server  or  groups  of  servers.  Click  Manage  install/update  profiles  below  the 
Physical  Servers  form  to  configure  the  profiles: 
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Step  4.  Add  logical  servers 

Once  physical  server  is  added,  you  can  add  logical  servers: 

1.  Select  the  type  of  logical  server  you  want  to  add  and  click  Submit. 

Choosing  Use  defaults  for  this  server  will  apply  default  names  for  Parallels  H-Sphere 
logical  servers  on  this  server.  By  default,  they  are  named  web N,  mail N,  nsN, 
mail N,  mysqiA/,  respectively. 


You  can  edit  logical  server  parameters,  if  necessary. 

Step  5.  Choose  between  full  and  reduced  installation 

Now  that  you’re  done  with  Parallels  H-Sphere  configuration: 

1 . Click  Proceed  With  Installation  Wizard. 

Note:  If  you  choose  to  Skip  Installation  Wizard,  you  will  be  taken  directly  to 
Administrator  Control  Panel  and  all  your  pre-configuration  will  be  lost. 

2.  Choose  the  installation  mode:  full  or  reduced  installation. 

Interrupted  Installation 

If  at  any  point  of  your  installation  process,  you: 

■ Go  to  your  wizard  Home  in  the  middle  of  installation 

■ Loose  connection  with  your  browser 

■ Skip  installation  (as  on  Step  5) 

you  will  have  a choice  of  further  actions: 

■ Proceed  with  Installation  Wizard  will  take  you  to  the  point  of  interrupted  installation 
process 

■ Go  to  Admin  CP  will  take  you  to  your  administrator  panel  without  completing 
installation 

■ Clear  Installed  Data  will  cancel  all  settings  and  you  can  start  installation  from  scratch 
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Step  3.  Completing  Parallels  H-Sphere 
Installation  Wizard 


There  are  two  alternative  ways  to  complete  full  installation:  via  Control  Panel  web 
interface  or  running  Parallels  H-Sphere  install/update  script  with  postinstall  option. 

Option  One:  completing  installation  via  Control  Panel  web 
interface 

1.  On  the  page  that  appears  check  the  servers  you  want  to  be 
updated/installed  and  click  Start.  To  see  the  update  log,  click  the  server 
name  link. 

On  multiserver  installations,  you  can  see  the  update  process  simultaneously  on 
each  server.  To  do  it,  click  the  logical  server  links  to  switch  between  the  server  logs. 

Update  process  indicator  legend: 

■ Yellow:  ready  for  update 

■ Blue:  update  is  running 

■ Green:  update  successfully  finished 

■ Red:  update  finished  with  error.  If  update  fails,  you  will  see  an  error  message 
with  details. 

Important:  You  don’t  need  to  restart  the  whole  update  process  if  the  update  fails 
only  on  a certain  server.  Just  log  into  this  server  manually,  fix  possible  issues 
and  resume  this  step  on  this  particular  server. 

2.  When  update  is  finished  and  the  light  turns  green,  click  Proceed  to 
complete  installation. 

3.  On  the  page  that  appears,  click  Return  to  Admin  CP. 

You  will  be  taken  to  administrator  Control  Panel. 

Option  Two:  Completing  installation  with  postinstall  option 

Return  to  the  Parallels  H-Sphere  installation  script  (on  page  24)  and  choose  the 
postinstall  option  there: 

postinstall 

This  will  complete  Parallels  H-Sphere  installation  according  to  the  configuration  you 
built.  You  can  find  more  info  on  Parallels  H-Sphere  install  script  options  in  Appendix  B 
(on  page  36). 
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Installing  Parallels  SiteStudio  with 
Parallels  H-Sphere 

To  install  Parallels  SiteStudio  with  Parallels  H-Sphere,  run  after  the  Parallels  H-Sphere 
installation: 

# sh  U36.0P2  install  postinstall  sitestudio 
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Performing  Post-Installation  Tasks 


Built-in  Accounts 

Standard  Parallels  H-Sphere  installation  would  include  two  accounts,  neither  of  which 
may  be  deleted: 

1.  the  admin  account  (login:  admin,  password:  admin)  to  configure  system 
settings.  It  is  extremely  recommended  to  change  the  password  of  the 
admin  account  after  the  installation  and  testing  have  been  completed. 

2.  the  wwwuser  account  (login:  wwwuser,  password:  userwwww)  to  manage 
the  control  panel  domain. 

Control  Panel  URL 

After  the  installation,  the  control  panel  becomes  accessible  at  the  address: 

http : / / your_ip_address : 8080  or 
http://cp.your  domain  name: 8080 

If  your  Parallels  H-Sphere  has  been  configured  with  SSL  protection,  use  the 
addresses: 

https : / / your_ip_address  : 8443  or 
https://cp.your  domain  name: 8443 

See  also  Customize  your  Control  Panel  URL  documentation  in  System  Administrator 
Guide. 

DNS  Configuration 

Some  Parallels  H-Sphere  features  (like  webmail,  WebShell,  phpMyAdmin)  will  work 
only  after  you  add  a DNS  zone  and  an  instant  alias  template.  To  check  these  features 
immediately,  specify  in  the  DNS  configuration  of  your  local  workstation  (not  Parallels  H- 
Sphere  server)  that  Parallels  H-Sphere  primary  DNS  server  is  your  primary 
nameserver.  For  example,  if  your  workstation  is  Linux,  add  a corresponding  line  in 
/etc/resolv . conf . 


If  you  are  running  a one  box  installation,  you  can  have  two  DNS  IPs  for  nsl  and  ns2.  At 
least  two  DNS  servers  are  required  to  offer  domian  registration  services  with  OpenSRS 
or  Enom.  If  you  need  more  than  two  DNS  servers,  you  need  to  set  up  one  more  box, 
and  your  DNS  services  need  to  be  fully  reconfigured. 


PostgreSQL 
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The  Parallels  H-Sphere  Control  Panel  requires  the  postgresql  daemon  running.  Don’t 
start  Parallels  H-Sphere  Control  Panel  without  it.  To  find  out  if  PostgreSQL  is  running, 
type: 

Linux: 

/etc/init . d/postgresql  status 

FreeBSD: 

/usr/local/etc/rc . d/010 .pgsql . sh 
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Appendix  A.  Installing  with  Prepared 
Parallels  H-Sphere  Configuration 

It  is  possible  to  perform  Parallels  H-Sphere  installation  by  importing  a specially 
formatted  config.xml  file  with  all  Parallels  H-Sphere  physical  and  logical  servers’ 
configuration. 

Run  the  install  script  with  the  install  option.  In  the  installer’s  command  line,  enter: 
install  xml=CONFIG_XML_LOCATION  [ skip-sitestudio  ] 

Creating  config.xml  file 

Parallels  H-Sphere  includes  the  hsphere-inf  o package  installed  on  each  Parallels 
H-Sphere  Unix  server.  The  package  installs  the  /hsphere/shared/bin/hsinfo 
script  on  each  server,  and  the  script  collects  information  about  this  server  into  the 

/hsphere/  shared/ etc/ con  fig.  xml  file. 

The  hsinfo  has  the  following  syntax: 

Usage : 

hsinfo  [ -ame  ] [ -p  box  IP  ] [ -g  group  ] [ -t  type  ] [ -f 

xmlfile  ] [ -s  delimiter  ] 

hsinfo  -1  [ -p  box  IP  ] [ -g  group  ] [ -s  delimiter  ] [ -f 

xmlfile  ] 

hsinfo  -i  [ -ame  ] [ -g  group  ] [ -f  xmlfile  ] [ -s  delimiter  ] 
hsinfo  -n  [ -p  box  IP  ] [ -g  group  ] [ -f  xmlfile  ] 

hsinfo  -o  a[ddress] |i[nterface] |n [umber]  [ -f  xmlfile  ] 

hsinfo  -d  [ -f  xmlfile  ] 

hsinfo  -v  [ -f  xmlfile  ] 

hsinfo  -G 

hsinfo  -T 

hsinfo  -h  -1  list  of  logical  server  names 

■ i list  of  physical  server  IPs  -n  domain  name  of  the  logical 
server 

■ d servise  zone  name  -p  phisical  box  IP  (default:  local 
physical  box) 


v hspere  version 
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■ a show  IP  address  -m  show  mask 

■ e show  external  IP  addreyyss 

■ o show  network  interface  name  of  the  physical  IP 

■ G list  of  possible  logical  server  groups 

■ T list  of  possible  IP  types 

■ h help 

by  default  show  only  IP  addresses 

group:  cp,  mail,  unix  hosting,  windows  hosting,  mysql,  pgsql, 
mssql,  dns,  mrtg,  system  (default:  all) 

type:  system,  service,  shared,  dedicated,  resellerSSL, 
resellerDNS,  all  (default:  service) 

xmlfile:  XML  file  location  (default: 

/hsphere/ shared/ etc/ con fig. xml ) 

The  /hsphere/ shared/etc/config.  xml  XML  file  contains  information  about 
physical  and  logical  server  names,  ids,  IPs;  system  zones;  current  Parallels  H-Sphere 
version,  etc. 

Sample  config.xml 

The  /hsphere/iocal/ conf ig/ customs/ customs  utility  returns  the  files 
customized  by  user  according  to  the  customization  conf_fiie.  It  has  the  following 
syntax: 

Usage : 

customs  [ -hmv  ] [ -c  conf  file  ] { package  namel  } 

[ package  name2  ...  ] 

■ h : to  see  this  help  message; 

■ m : to  return  the  masks  of  the  given  packages  (names  only) ; 

■ v : verbose,  package  mask  output  before  the  list  of  its 
customized  files; 

■ c conf  file  : path  to  the  user  customization  configuration 
file , 

default : /hsphere/iocal/ config/ customs/ customs . conf; 

package  nameN  : name  of  the  package  to  list  the  customized  files 
for . 
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Appendix  B.  Installation  Script  Options 


Parallels  H-Sphere  installation  is  performed  by  a script  that  brings  about  more  flexibility 
in  the  process  of  installation  and  introduces  a variety  of  advanced  features  and 
improvements. 

> Before  running  Parallels  H-Sphere  installer: 

1.  Download  the  install  script.  For  example,  for  Parallels  H-Sphere  3.6.3 
run  under  root  on  Linux  box: 

# wget 

http: //download. hsphere .parallels . com/ shiv/HS/releases/U36 . 0/U36 . 0P2/U 
36.0P2 

2.  Run  script  the  script  in  the  install  mode: 

# sh  U36.0P2  install 

You  will  get  the  list  of  installation  modes,  each  having  its  own  options. 

(1)  install— Full  installation  mode.  Requires  prepared  config.xml  with  Parallels  H- 
Sphere  cluster  configuration. 

(2)  cpinstaii-Control  Panel  installation  mode.  Afterwards,  log  into  Parallels  H- 
Sphere  Control  Panel  Web  interface,  go  through  Pre-Configuration  wizard,  and  then 
complete  installation  in  mode  (3). 

(3)  postinstall-post-installation  Parallels  H-Sphere  cluster  configuration,  to  be 
run  after  mode  (2). 

(4)  sitestudio— install  Parallels  SiteStudio  on  the  Control  Panel  box. 

(5)  sitebuilder-install  Parallels  Presence  Builder  on  the  Control  Panel  box  (for 
Parallels  H-Sphere  3.3  and  up). 

If  you  want  more  information  on  every  mode,  simply  type  its  number  in  the  command 
line. 

Install  Modes: 

■ install  - Parallels  H-Sphere  installation  from  the  prepared  config.xml  file  with 
configuration  of  Parallels  H-Sphere  cluster  to  be  installed,  config.xml  contains 
information  about  Parallels  H-  Sphere  physical  and  logical  servers,  with  root 
passwords  to  physical  server  where  Parallels  H-Sphere  is  to  be  installed  (see 
sample  config.xml  at 

http://download.hsphere.parallels.com/HSdocumentation/xmls/confiq.xml).  During 
the  installation  this  file  is  temporarily  stored  in  the  -cpanei/ . settings  directory. 
You  can  also  use  the  cpinstall  mode  and  run  Parallels  H-Sphere  Pre-Configuration 
Wizard  in  administrator  Control  Panel  to  create  and  import/export  config.xml. 

install  xml=CONFIG  XML  [ skip-sitestudio  ] [ url=Link  ] [ 

mirror=mirror  number  ] 
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■ cpinstall  - install  only  system  PostgreSQL  and  packages  to  be  able  to  run  Control 
Panel.  Later  on,  you  need  to  log  into  administrator  Control  Panel  and  go  through 
Parallels  H-Sphere  Pre-Configuration  Wizard  to  shape  your  Parallels  H-Sphere 
cluster,  and  finally,  run  the  installer  in  the  postinstall  mode. 

cpinstall  zone=SERVICE_ZONE  ip=IPl  [ ip2=IP2  ] [ natip=NAT_IP 

] [ mask=MASK  ] [ url=Link  ] f mirror=mirror  number  ] 

■ postinstall  - run  this  mode  to  complete  Parallels  H-Sphere  installation  after 
cpinstall  and  after  adding  servers  and  services  in  the  Parallels  H-Sphere  Pre- 
Configuration  mode  in  administrator  Control  Panel. 

postinstall 

■ sitestudio  - install  Parallels  SiteStudio  on  the  Control  Panel  box. 

sitestudio  [ url=Link  ] [ mirror=mirror  number  ] 

■ sitebuilder  - install  Parallels  Presence  Builder  on  the  Control  Panel  box. 

sitebuilder  f url=Link  ] [ mirror=mirror  number  ] 

Where: 

Obligatory  Parameters: 

■ xml  - the  path  to  config.xml  file.  This  path  should  not  be 

/hsphere/ shared/ etc/con fig. xml 

■ zone  - service  domain  name  (e.g.,  sampiehosting.com). 

■ ip  - service  zone  IP  - IP  of  Control  Panel  box. 

Optional  parameters: 

■ ip2  - the  IP  of  the  second  DNS  logical  server  (ns2).  If  ip2  is  not  set,  the  ns2  logical 
server  will  not  be  created. 

■ natip  - the  external  server  IP  for  NAT  mapping. 

■ mask  - the  network  mask.  If  mask  is  not  set,  the  default  value  (255.255.255.0)  is 
used. 

■ skip-sitestudio  - install  Parallels  H-Sphere  without  Parallels  SiteStudio. 

■ group  - comma-separated  list  of  logical  servers  to  be  installed.  Possible  groups: 
mail,  web,  dns,  mysql,  pgsql,  cp,  vps  (using  common  ips  and  group  tags  is 
allowed). 

■ url  - alternative  path  to  package  download,  this  option  differs  from  ‘mirror’,  which 
includes  predefined  list  of  the  maintained  HS  mirrors.  Package  lists  are  downloaded 
from  default  location  or  mirror,  pointed  via  mirror  option.  (Default  path  is 

http : // download .hsphere .parallels. com/ shiv/HS) 

■ mirror  - allows  setting  another  mirror  instead  of  the  default  one.  At  this  moment 
available  the  following  HS  servers:  [0]  - download . hsphere  . parallels  . com 
(default)  and  [1]  - download2  . hsphere  .parallels,  com  (mirror). 
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Appendix  C.  Customizing  Server 
Configuration  Files  by  Means  of 
Templates 


You  cannot  customize  some  major  service  configuration  files  (for  Web,  mail,  DNS, 
databases)  directly,  as  your  changes  in  these  files  will  be  overwritten  with  a 
consequent  Parallels  H-  Sphere  update!  Instead,  you  need  to  create  configuration  file 
templates  by  means  of  the  hsphere-update  wrapper  and  customize  these  templates 
instead  of  default  configuration  files. 

You  can  customize  configuration  file  templates  by  means  of  Parallels  H-Sphere 
updater,  provided  you  have  not  customized  your  templates  already.  For  this  purpose 
two  new  options  are  added  to  the  hspackages  wrapper  of  the  Parallels  H-Sphere 
update  script: 

■ hspackages  ctempiates=  [options ] - Place  custom  templates  for  comma- 
separated  list  of  services  into  predefined  locations  if  custom  templates  are  not  there 
already. 

■ hspackages  edit=IP : /path/ to/ custom/ template  - Edit  custom  template 
on  a specified  server  in  a specified  location. 


Important: 

If  you  run  the  hspackages  ctemplates  command  without  options,  it  will  create  custom 
templates  on  all  related  servers  of  the  Parallels  H-Sphere  cluster!  To  specify 
particular  servers  where  custom  configuration  templates  should  be  created,  please 
use  the  extended  syntax  of  the  hspackages  command.  For  example,  to  create  PHP 
custom  configuration  templates  only  on  the  physical  boxes  1 92.1 68.1 .1 0 and 
192.168.1.11,  run: 

hspackages  ctemplates=php  ips=192 . 168 . 1 . 10, 192 . 168 . 1 . 11 

The  hspackages  ctemplates  command  should  be  run  only  once,  in  order  to  create 
custom  configuration  templates!  Then  you  customize  these  files  according  to  your 
needs.  Next  time  you  run  it,  it  will  prompt  re-creating  your  custom  configuration 
templates,  thus  you  may  lose  your  customization! 

The  only  exclusion  when  you  need  to  run  hspackages  ctemplates  again  is  when  a 
coming  version  of  the  hsphere-update  package  contains  updates  of  default 
configuration  templates.  You  will  be  specially  notified  of  this  in  the  respective  update 
notes. 
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Control  Panel  Apache 

Default  Control  Panel  Apache  httpd.conf  template  is  included  into  the  hsphere- 
update  and  installed  here: 

/hsphere/pkg/ scripts /templates/ cpapache/httpd . conf . tmpl .default 


> To  customize  the  template: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http : //download .hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=httpdcp  option: 
hspackages  ctemplates=httpdcp  [OPTIONS] 

Custom  template  will  be  placed  into  the  following  location: 

/hsphere /local /home/ cpanel /apache/ etc/httpd. conf . tmpl . custo 
m 

1.  Edit  the 

/hsphere/ local /home/ cpanel / apache /etc/httpd. conf. tmpl 
. custom  file  according  to  your  needs. 

2.  To  immediately  apply  changes,  run  the  conf  file  generating  script  which 
is  as  a rule  executed  in  the  postinstall  section  of  the  package: 

/hsphere/ shared/ scripts /apache- re start 


Extra  Control  Panel  Apache  Configuration 
Files 


Parallels  H-Sphere  allows  to  customize  some  extra  Apache  configuration  files  for 
Control  Panel.  They  are  located  in  the 

/hsphere/local/home/ cpanel/ apache/conf / extra/  directory: 

■ httpd-autoindex . conf  - directives  controlling  the  display  of  server-generated 
directory  listings 

■ httpd-cache . conf  - directives  providing  HTTP  content  cache  configuration 

■ httpd-inf  o . conf  - Apache  status-related  directive  blocks 
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■ httpd-ianguages . conf  - directives  which  provide  the  mod  mime  and 
mod_negotiation  modules  global  configuration 

■ vh-ss l-defauit . conf  - Global  SSL  default  VirtualHost  configuration 

These  extra  configuration  files  are  provided  for  easier  configuration  of  Apache 
modules,  such  as  mod_cache,  mod_security,  etc. 

After  the  configuration  file  customization,  the  correspondent  * . tmpi . custom  files  will 
be  created  in  the  same  directory: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http : //download. hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=httpdcp_extra 
option: 

hspackages  ctemplates=httpdcp_extra  [OPTIONS] 

After  that,  custom  templates 

/hsphere /local /home/  cpanel/  apache/  conf/  extra/*,  tmpl . custom  will 
be  created. 

2.  Edit  the 

/hsphere/ local /home/ cpanel/ apache/ conf/ extra/* . tmpl . c 
ustom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  Apache: 

/hsphere/ shared/ scripts/apache-restart 


Apache 

Default  configuration  Apache  templates  are  included  into  the  hsphere-update 
package  and  installed  in  the  following  locations: 

/hsphere /pkg/ scripts/ template s/hs- 
31/ apache /httpd . conf . tmpl .default 
/hsphere /pkg/ scripts/ template s/hs- 
31/ apache/httpd2 . conf . tmpl . default 
/hsphere /pkg/ scripts/ template s/hs- 
31apache/lsrv . conf . tmpl .default 


> To  customize  them,  perform: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 
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# wget 

http: //download .hsphere. parallels .com/shiv/HS/releases/U36. 0/ 

U36.0P2/U36.0P2 


2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctemplates=httpd  option  for 
Apache  1 .3  and/or  ctempiates=httpd2  option  for  Apache  2.2: 

hspackages  ctemplates=httpd  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  locations: 

/hsphere /local/ conf ig/httpd/lsrv . conf . tmpl . custom 
/hsphere/local/ conf ig/httpd/httpd. conf . tmpl . custom 
/hsphere /local/ conf ig/httpd2 /lsrv . conf . tmpl . custom 
/hsphere/local/ conf ig/httpd2 /httpd . conf . tmpl . custom 

2.  Edit  the  . custom  files  according  to  your  needs: 

/hsphere/local/ conf ig/httpd/lsrv . conf . tmpl . custom 
/hsphere/local/ conf ig/httpd/httpd . conf . tmpl . custom 

3.  To  immediately  apply  changes,  run  the  conf  file  generating  script  which 
is  as  a rule  executed  in  the  postinstall  section  of  the  package: 

/hsphere/ shared/ scripts /apache- re start 

Customizing  /hsphere/shared/apache/htdocs/index.html 

If  you  need  to  leave  /hsphere/ shared/apache/htdocs/ index  . html  unchanged 
after  the  update,  create  the  following  file: 

touch  /hsphere/ local/ conf ig/httpd/ index . html . custom 

If  the  latter  file  exists,  then  you  can  customize  your  index . html  file  without  the  risk  of 
its  being  overwritten. 


Extra  Apache  Configuration  Files 

Parallels  H-Sphere  allows  to  customize  some  extra  Apache  configuration  files,  such  as: 

■ httpd-autoindex . conf  - directives  controlling  the  display  of  server-generated 
directory  listings 

■ httpd-cache . conf  - directives  providing  HTTP  content  cache  configuration 
(Apache  2.2  only) 

■ httpd-gzip . conf  - directives  for  global  settings  provided  by  the  mod_gzip 
module  (Apache  1 .3  only) 

■ httpd-inf  o . conf  - Apache  status-related  directives 

■ httpd-ianguages . conf  - directives  which  provide  the  mod_mime  and 
mod_negotiation  modules  global  configuration 

■ httpd-security . conf  - ModSecurity  configuration  options 
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■ httpd-security2  . conf  - ModSecurity  v.2  configuration  options  (Apache  2.2 
only) 

■ vh-ssi-de fault . conf  - global  SSL  default  VirtualHost  configuration 

Default  templates  * . tmpi . default  for  these  configuration  files  are  installed  with 
hsphere-updater  to  the  following  directories: 

Apache  1.3: /hsphere/pkg/scripts/templates/hs- 
31/ apache /extra .default/ 

Apache  2.2:  /hsphere/pkg/scripts/templates/hs- 
31/ apache /ext ra2 . default/ 

After  Parallels  H-Sphere  3.2  update,  the  respective  custom  . tmpi . custom  files  will  be 
created  in  the  following  directories: 

Apache  1.3: /hsphere/local/config/httpd/extra/ 

Apache  2.2:  /hsphere/local/config/httpd2/extra/ 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http: //download. hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctemplates=httpd_extra 

option: 

hspackages  ctemplates=httpd_extra  [OPTIONS] 

After  that,  custom  templates  * . tmpi . custom  will  be  created  in  respective 
directories. 

2.  Edit  the  * . tmpi . custom  files  according  to  your  needs: 

Apache  1.3:  /hsphere/local/conf ig/httpd/extra/* . tmpi . custom 
Apache  2.2:  /hsphere/local/ conf ig/httpd2 /extra/* . tmpi . custom 

3.  To  immediately  apply  changes,  restart  Apache: 

/hsphere/ shared/ scripts/apache-restart 


PHP4 

PHP  4 configuration  files  are  located: 

/hsphere/local/ config/httpd/php4/php. ini . tmpi . custom  (when  PHP4 
uses  fastcgi,  for  all  Apache  versions) 

/hsphere/local/ config/httpd/php4/php.  ini  . tmpi . custom  (when  Iibphp4 
is  used,  for  Apache  1.x) 
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/hsphere/ local/ conf  ig/httpd2/php4  /php  . ini  . tmpl . custom  (when  Iibphp4 
is  used,  for  Apache  2.x) 

> To  customize  PHP  4 configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http: //download. hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=php  option: 
hspackages  ctemplates=php  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  location: 

/hsphere /local/ conf ig/httpd2 /php 4 /php . ini . tmpl . custom 

/hsphere/local/ config/httpd/php4/php . ini . tmpl . custom 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  Apache  service: 

/hsphere/ shared/ scripts/apache-restart 


PHP  5 


PHP  5 configuration  files  are  located: 

/hsphere/local/ config/httpd/php5/php. ini . tmpl . custom  (when 
PHP5  uses  fastcgi,  for  all  Apache  versions) 

/hsphere/local/ config/httpd/php5/php. ini . tmpl . custom  (when 
Iibphp5  is  used,  for  Apache  1.x) 

/hsphere/local/ conf ig/httpd2/php5 /php . ini . tmpl . custom  (when 
Iibphp5  is  used,  for  Apache  2.x) 

> To  customize  PHP  5 configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http: //download .hsphere .parallels . com/shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 


2.  Run  the  update  script: 
# sh  ./U36.0P3 
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3.  Execute  the  hspackages  wrapper  with  the  ctempiates=php  option: 
hspackages  ctemplates=php  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  location: 

/hsphere/local/ config/httpd/php5/php . ini . tmpl . custom 
/hsphe re /local/ conf ig/httpd2 /php5/php . ini . tmpl . custom 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  Apache  service: 

/hsphere/ shared/ scripts/apache-restart 


PHP5.3 


PHP  5.3  configuration  files  are  located: 

/hsphere/local/ conf ig/httpd2/php53  ts/php . ini . tmpl . custom  (when 
Iibphp5  is  used,  for  Apache  2.x  and  mpm_worker) 

/hsphere/local/ config/httpd2/php53/php.  ini  . tmpl . custom  (in  all  Other 
cases) 

> To  customize  PHP  5.3  configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

a.  Download  H-Sphere  updater: 

# wget 

http: //download .hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

b.  Run  the  update  script: 

# sh  ./U36.0P3 

C.  Execute  the  hspackages  wrapper  with  the  ctemplates=php 
option: 

hspackages  ctemplates=php  [OPTIONS] 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  the  Apache  service: 

/hsphere/ shared/ scripts/apache-restart 


PHP  5.4 


PHP  5.4  configuration  files  are  located: 
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/hsphere/ local/ conf ig/httpd2/php5  4 ts/php . ini . tmpl . custom  (when 
Iibphp5  is  used,  for  Apache  2.x  and  mpm_worker) 

/hsphere/local/ config/httpd2/php54/php.  ini  . tmpl . custom  (in  all  Other 
cases) 

> To  customize  PHP  5.4  configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

a.  Download  H-Sphere  updater: 

# wget 

http: //download. hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

b.  Run  the  update  script: 

# sh  ./U36.0P3 

C.  Execute  the  hspackages  wrapper  with  the  ctemplates=php 
option: 

hspackages  ctemplates=php  [OPTIONS] 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  the  Apache  service: 

/hsphere/ shared/ scripts/apache-restart 


PHP  5.5 


PHP  5.5  configuration  files  are  located: 

/hsphere/local/ conf ig/httpd2/php55  ts/php . ini . tmpl . custom  (when 
Iibphp5  is  used,  for  Apache  2.x  and  mpm_worker) 

/hsphere/local/ config/httpd2/php55/php.  ini  . tmpl . custom  (in  all  Other 
cases) 

> To  customize  PHP  5.5  configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

a.  Download  H-Sphere  updater: 

# wget 

http: //download. hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 


b.  Run  the  update  script: 
# sh  ./U36.0P3 
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C.  Execute  the  hspackages  wrapper  with  the  ctemplates=php 
option: 

hspackages  ctemplates=php  [OPTIONS] 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  the  Apache  service: 

/hsphere/ shared/ scripts/apache-restart 
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Standardized  PHP 


Standardized  PHP  configuration  file  is  located: 

/hsphere/ shared/php- 
internal/conf /php . ini . tmpl . custom 

> To  customize  standardized  PHP  configuration  files: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

a.  Download  H-Sphere  updater: 

# wget 

http : //download .hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

b.  Run  the  update  script: 

# sh  ./U36.0P3 

C.  Execute  the  hspackages  wrapper  with  the  ctemplates=php 
option: 

hspackages  ctemplates=php  [OPTIONS] 

2.  Edit  the  above  mentioned  tmpl . custom  files  according  to  your  needs. 

3.  To  immediately  apply  changes,  restart  the  Apache  service: 

/hsphere/ shared/ scripts /apache -res tart 


FTP 


FTP  configuration  file  templates  are  included  into  the  hsphere-update  package  and 
installed  in  the  following  locations: 

/hsphere /pkg/ scripts /templates /pro ftpd/ shared. prof tpd. con f . tmpl . 
default 

/hsphere /pkg/ scripts/ templates /pro ftpd/ lo cal. prof tpd. conf. tmpl . d 
ef ault 


> To  customize  these  templates,  perform: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 
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# wget 

http: //download .hsphere. parallels . com/shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=ftpd  option: 
hspackages  ctemplates=f tpd  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  locations: 

/hsphere /local/ con fig/ f tpd/prof tpd . conf . tmpl . custom 
/hsphere/ shared/ conf ig/ f tpd/prof tpd. conf . tmpl . custom 

2.  Edit  the  . custom  files  according  to  your  needs: 

/hsphere /local/ config/f tpd/ prof tpd. conf. tmpl . custom 
/hsphere/ shared/ config/ f tpd/prof tpd . conf . tmpl . custom 

3.  To  immediately  apply  changes,  run: 

/hsphere/ shared/ conf ig/f tpd/ conf igure-prof tpd . sh 

4.  Restart  FTP  service. 
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MySQL 

MySQL  configuration  file  templates  are  included  into  the  hsphere-update  package  and 
installed  in  the  following  locations: 

Linux: /hsphere/pkg/ scripts /templates /FreeBSD/my . cnf  tmpl .default 
FreeBSD: /hsphere/pkg/ scripts/templates/Linux/my . cnf  tmpl . default 


> To  customize  these  templates,  perform: 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http : //download .hsphere .parallels . com/shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=mysqi  option: 
hspackages  ctemplates=mysql  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  location: 

/hsphere /local/ conf ig/mysql/my . cnf  tmpl . custom 

2.  Edit  the  /hsphere/ local /conf ig/mysql/my . cnf_tmpl . custom 

file  according  to  your  needs. 

3.  To  immediately  apply  changes,  run  the  conf  file  generating  script  which 
is  as  a rule  executed  in  the  package  postinstall  section: 

/hsphere /local /conf ig/mysql/ scripts /conf ig_mysql 


PostgreSQL 

PostgreSQL  configuration  file  templates  are  included  into  the  hsphere-update  package 
and  installed  in  the  following  locations: 

Linux: 

/hsphere/pkg/ scripts/ templates/FreeBSD/postgresql . conf  tmpl . defa 
ult 

FreeBSD: 

/hsphere/pkg/ scripts/templates/Linux/postgresql . conf  tmpl . def aul 
t 


> To  customize  these  templates,  perform: 
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1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http: //download .hsphere. parallels .com/shiv/HS/releases/U36. 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctempiates=pgsqi  option: 
hspackages  ctemplates=pgsql  [OPTIONS] 

Custom  templates  will  be  placed  into  the  following  location: 

/hsphere/local/ conf ig/pgsql/postgresql . conf  tmpl . custom 

2.  Edit  the 

/hsphere/ local/ config/pgsql/postgresql. conf_tmpl .oust 

om  file  according  to  your  needs. 

Important:  By  default,  PostgreSQL  listens  on  localhost  (parameter 
virtual_host=1 27.0.0.1  in  configuration  file).  Change  this  parameter  if  required. 

3.  To  immediately  apply  changes,  run  the  conf  file  generating  script  which 
is  as  a rule  executed  in  the  package  postinstall  section: 

/hsphere /local /conf ig/pgsql/ scripts /conf ig_pgsql 


DNS 

/etc/named.conf 

Default  template  is  located  at 

/hsphere /pkg/ scripts/ templates /named/ named. conf . tmpl .default 

1.  Create  custom  configuration  template  if  required.  Otherwise,  skip  this 
step. 

1 . Download  H-Sphere  updater: 

# wget 

http : //download .hsphere .parallels . com/ shiv/HS/releases/U36 . 0/ 

U36.0P2/U36.0P2 

2.  Run  the  update  script: 

# sh  ./U36.0P3 

3.  Execute  the  hspackages  wrapper  with  the  ctemplates=named  option: 
hspackages  ctemplates=named  [OPTIONS] 

Custom  template  will  be  placed  into  the  following  location: 

/etc/named.conf  .tmpl. custom 
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2.  Edit  the  /etc/named . conf . tmpl . custom  file  according  to  your 
needs. 

3.  To  immediately  apply  changes,  run  the  configuration  file  generating 
script  which  is  as  a rule  executed  in  the  postinstall  section  of  the 
package: 

/hsphere/ local/ conf ig/bind/ scripts/ conf ig_bind 

/etc/resolv.conf 

To  leave  /etc/resoiv.  conf  unchanged  during  the  update  (e.g.,  when  MyDNS  is 
used),  perform: 

touch  /etc/resolv.conf .custom 

If  the  latter  file  exists,  then  you  can  customize  your  /etc/resoiv . conf  file  without 
the  risk  of  its  being  overwritten. 


Other  Files  Included  into  Parallels  H- 
Sphere  Packages 


Warning:  It  is  not  recommended  that  you  customize  the  files  included  into  Parallels  hl- 
Sphere  packages  by  yourself.  Any  alterations  made  to  them  are  at  your  own  risk! 


Besides  customization  of  some  major  service  configuration  files  (for  Web,  mail,  DNS, 
databases,  etc.),  we  have  implemented  for  your  convenience  a possibility  to  customize 
other  files  included  into  Parallels  H-Sphere  packages.  For  this,  we  have  created  a 
configuration  file  /hsphere/local/ config/ customs/ customs  . conf  and  a 
Special  template  /hsphere/local/ config/ customs/ customs  . conf  . tmpl  that 
will  help  you  to  save  customized  Parallels  Pi-Sphere  packages  files  during  future 
updates. 

> To  customize  a file  included  into  Parallels  H-Sphere  Package  and  save  the 
changes: 

1.  Make  necessary  changes  to  the  file  you  want  to  customize. 

2.  Copy  a template  of  custom  files  to  a configuration  file: 

cp  -p  /hsphere/local/ conf ig/cus toms/customs .conf . tmpl 
/hsphere/ local/ config/ customs /customs . conf 

3.  Go  to  the  customs . conf  file 

4.  Add  the  full  path  to  the  customized  file(-s)  under  the  mask  of  the 
relevant  package,  e.g.: 
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[hsphere-imap-h2 . 5] 

/ etc/ rc . d/ ini t . d/ courier- imapd 
/ etc/ rc . d/ ini t . d/ courier-imapd-ssl 
/hsphere/ local/ conf ig/mail/ imap/e tc/ imapd 
/hsphere/local/ conf ig/mail/ imap/e tc/imapd-s si 

Please  note  that  during  the  package  updates  all  custom  files  will  be  saved  in  the 

/hsphere/local/ conf  ig/ customs/ $package_mask/  directory.  The  default  files 
of  Parallels  H-Sphere  packages,  in  their  turn,  will  be  stored  at 

/hsphere/local/conf ig/customs/def ault/$package_mask/.  The  above 
mentioned  locations  store  the  latest  versions  of  both  custom  and  default  files,  no  matter 
custom  or  default  file  is  being  used. 
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Appendix  D.  Download  Locations 


This  table  contains  codes  for  all  Linux/FreeBSD  operating  systems  supported  by 
Parallels  Pi-Sphere  and  links  to  the  directories  on  the 

http://download.hsphere.parallels.com  website  where  you  can  download  packages 
required  by  Parallels  Pi-Sphere. 


Operating  System 

OSCODE 

Download  Location 

RedPlat  EL  4,  CentOS 
4.x,  White  Box  EL  4.x 

RHES4 

http : // download. hsphere . parallels . c 

om/shiv/HS/RHES4 

RedPlat  EL  4,  CentOS 
4.x,  White  Box  EL  4.x 
(x86_64) 

RHES464 

http : // download. hsphere . parallels . c 

om/shiv/HS/RHES4  64 

RedPlat  EL  5,  CentOS 
5.x,  CloudLinux  5.5 

RHES5 

http : // download. hsphere . parallels . c 

om/ shiv/HS/RHES5 

RedPlat  EL  5,  CentOS 
5.x  (x86_64) 

RHES564 

http : / / download. hsphere . parallels . c 

om/shiv/HS/RHES5  64 

RedPlat  EL  6,  CentOS 
6.x 

RHES6 

http : // download. hsphere . parallels . c 

om/ shiv/HS/RHES6 

RedPlat  EL  6,  CentOS 
6.x  (x86_64) 

RHES664 

http : // download. hsphere . parallels . c 

om/shiv/HS/RHES6  64 

FreeBSD  7.3 

FBSD73 

http : // download. hsphere . parallels . c 

om/ shiv/HS/FBSD73 

FreeBSD  7.3  (amd64) 

FBSD73  64 

http : // download. hsphere . parallels . c 

om/shiv/HS/FBSD73  64 

FreeBSD  7.4 

FBSD74 

http : // download. hsphere . parallels . c 

om/shiv/HS/FBSD74 

FreeBSD  7.4  (amd64) 

FBSD74  64 

http : // download. hsphere . parallels . c 

om/shiv/HS/FBSD74  64 

In  this  chapter: 

Mirror  Server  for  Updating  Parallels  Pi-Sphere 
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Mirror  Server  for  Updating  Parallels  H- 
Sphere 

If  you  have  2 and  more  boxes  with  the  same  operating  system  and  you  want  to  speed 
up  package  downloads,  you  can  create  a mirror  server  and  in  the  updater  set  an 
alternative  URL  for  package  downloads. 

> To  create  a mirror: 

1 . Set  up  a web  server  (or  just  an  IP-based  virtual  host  in  existing  web 
server). 

2.  In  the  web  server’s  (or  appropriate  virtual  host’s)  document  root 
directory,  create  directory  shiv/HS/releases/U36 . 0P2/,  e.g. 
mkdir  -p  /var/www/html/shiv/HS/releases/U36 . 0P2/ 

3.  Download  all  contents  of 

http://download.hsphere.parallels.eom/shiv/HS/releases/U36.0/  into 

your  shiv/HS/releases/U36 . 0P2/  directory. 

4.  Download  the  script 

http : // download . h sphere .parallels . com/ shiv/ HS / release 
s / sync  3 60  from  Public . sh,  adjust  it  for  your  paths,  and  run: 
sh  sync360f romPublic . sh 

5.  This  will  download  you  H-Sphere  packages  according  to  the  package 
lists  in  shiv/HS/releases/U36.0P2/. 

Now  you  can  specify  this  mirror  server  to  be  used  by  the  Parallels  H-Sphere 
install/update  script  by  setting  the  mirror  parameter. 
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Appendix  E.  Miscellaneous 


56 

57 


In  this  chapter: 

Restarting  Parallels  H-Sphere 

Network  Address  Translation  (NAT) 


Restarting  Parallels  H-Sphere 

When  restarting  the  Control  Panel,  make  sure  that  you  are  logged  into  the  Control 
Panel  server  as  root. 

For  Linux: 

/etc/rc.d/init.d/httpdcp  stop 
killall  -9  java 
sleep  10 

/etc/rc.d/init.d/httpdcp  start 
For  FreeBSD: 

/usr/local/etc/rc.d/apachecp.sh  stop 
killall  -9  java 
sleep  10 

/usr/local/etc/rc.d/apachecp.sh  start 
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Network  Address  Translation  (NAT) 

Parallels  H-Sphere  supports  NAT  (Network  Address  Translation)  which  allows  you  to 
use  internal  IPs  in  your  local  area  network.  When  configuring  Parallels  H-Sphere,  use 
internal  IPs  in  all  instances,  and  Parallels  H-Sphere  will  convert  them  into  external  IPs 
for  the  DNS  settings  and  control  panel  web  interface. 

> To  enable  NAT  support  in  Parallels  H-Sphere: 

1.  Log  into  Control  Panel  server  as  cpanel  user: 

1 . Log  in  as  root  first: 

$ su  - 

2.  Log  in  as  the  cpanel  user: 

# su  -1  cpanel 

2.  Create  the  ips-map . xml  file  in  the 

~cpanel/ shiva/psof t_conf ig/  directory  in  the  following  format: 

<ips> 

<ip  ext =" external  ip"  int =" internal  ip" /> 

</ ips> 

Example: 

<ips> 

<ip  ext="65 .219.197.236"  int="l 92 . 1 68 . 1 . 27"/> 

<ip  ext ="65. 219. 197. 237"  int="192 . 168 . 1 . 28"/> 

<ip  ext="65 .219.197.238"  int="l 92 . 1 68 . 1 . 2 9"/> 

<ip  ext="65 .219.197.239"  int="l 92 . 1 68 . 1 . 30"/> 

<ip  ext=" 65.219.197.242"  int="l 92 . 1 68 . 1 . 31"/> 

<ip  ext ="65. 219. 197. 243"  int="l 92 . 1 68 . 1 . 32"/> 

<ip  ext ="65. 219. 197. 244"  int="l 92 . 1 68 . 1 . 33"/> 

</ ips> 

3.  Set  the  following  record  in 

~ cpanel / shiva /psof t_conf ig/hsphere .properties: 
IPS-XML-FILENAME  = 

/hsphere/ local /home/ cpanel/ shiva/ psoft  config/ ips-map . xml 

4.  Restart  Parallels  H-Sphere  to  apply  changes.  To  do  this,  run  under 

root: 

For  Linux: 

/etc/rc.d/init.d/httpdcp  stop 
killall  -9  java 
sleep  10 

/etc/rc.d/init.d/httpdcp  start 
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For  FreeBSD: 

/usr/local/etc/rc.d/apachecp. sh  stop 
killall  -9  java 
sleep  10 

/usr/local/etc/rc.d/apachecp. sh  start 


> To  disable  NAT  support 

1.  Remove  the  line  mentioned  in  step  3 above  from 

hsphe re. properties. 

2.  Restart  Parallels  H-Sphere. 

See  below  for  particular  cases  of  configuring  NAT  in  your  Parallels  H-Sphere  cluster. 


